home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / gen / ptwist / povtwist.doc < prev    next >
Text File  |  1993-09-04  |  4KB  |  100 lines
  1. POVTWIST V1.00 
  2. _____________________________
  3.  
  4.  
  5. Files include in PTWIST.ZIP -
  6.  
  7.     POVTWIST.EXE  - The compiled 'twister' generator.
  8.     POVTWIST.DOC  - Instructions for use of TWISTER.
  9.     TWISTED.POV   - Sample POV dat file to display 'twister'
  10.     TWISTED.GIF   - 320 X 200 picture of TWISTED.POV.
  11.     POVTWIST.C    - Source code for POVTWIST.EXE.
  12.  
  13.  
  14.         [ POVTWIST.EXE ]
  15.  
  16.   POVTWIST 1.0 is a new version of the original TWISTER 1.0 program written
  17. for DKBtrace by Drew Wells.  I have only changed the program to the extent
  18. that it will generate output for POVRAY.  This document has been changed
  19. accordingly.  At the suggestion of the original author, I created
  20. the POV version with a new unique name rather than add an option to
  21. make the original TWISTER program produce both DKB and POV output.
  22. The unique name will allow this program to coexeist with twister program.
  23. The example file twisted.pov was also modified from twisted.dat for POV.
  24. James P. Hawkins   [CIS 76520,3356]
  25.  
  26.   The program POVTWIST.EXE will create a data file for the POVRAY raytracer 
  27. describing an object that looks something like a twisted ribbon or a piece 
  28. of macaroni. I used this program to create the floating macavirus in 
  29. "Not a Trace of Reality" a.k.a Ntreal.gif. The 'twister' is a POV union made 
  30. up a many instances of a #declare'd quadric. POVTWIST.EXE generates the 
  31. complete code and a usable quadric, all the user needs to do is generate the 
  32. 'twister' pov file, #include it in a POV scene file and place the 'twister' 
  33. in their scene. TWISTED.POV is an example of how to use the file generated 
  34. by POVTWIST.EXE.    -Drew Wells
  35.  
  36. Parameters: [Default Values]
  37.  
  38.   File name: [twist.pov]
  39.     This is the name of the file generated by POVTWIST.EXE
  40.  
  41.   Union Name: [Macaroni]
  42.     Name of the 'twister' union to use in #declare statement.
  43.  
  44.   Quadric Name: [Part]
  45.     Name of the #declared quadric from which to build twister union.
  46.     POVTWIST.EXE creates a sample quadric from the name you supply, but 
  47.     any quadric may be used for the twister, just comment out the
  48.     sample quadric and supply your own.
  49.  
  50.   Length of twister : [20.0]
  51.     Version 1.00 of POVTWIST.EXE creates the object from the ground up.
  52.     The quadrics in twister union will start at Y = 0.0 and end at
  53.     Y = Length. The width is determined by the size of the quadric.
  54.  
  55.   Number of pieces : [50]
  56.     The number of quadrics to use in building the twister.
  57.     Low values make the twister blockier.
  58.     Higher values will create a smoother shape.
  59.  
  60.   Number of twists : [1.0]
  61.     How many complete twists the twister makes.
  62.     Values below 1.0 create a more gentle curve.
  63.     Higher values make the twister more corkscrew-ish.
  64.  
  65.  
  66.         [ TWISTED.POV ]  
  67.  
  68.   TWISTED.POV is a simple POV data file that demonstrates the use of the 
  69. file TWIST.POV. TWIST.POV is generated by running POVTWIST.EXE with the default
  70. values. On a IBM PC 386/20 & 387 coprocessor TWISTED.POV renders in about
  71. 3 minutes at 80 X 60 with no anti-aliasing and about 2 hours at 320 X 240 
  72. with default anti-aliasing.  [On a 486/50 rendering takes about 10 minutes
  73. at 320 X 200 -JPH].
  74.  
  75.  
  76.         [ POVTWIST.C ]
  77.  
  78.   POVTWIST.C is the C language source code to POVTWIST.EXE. It should compile 
  79. with any ANSI C compiler and I've tried to make it easily modifiable to create
  80. more complex shapes. You are free to modify the code and distribute, but not to
  81. extract payment for this code. Please comment your changes, use the update 
  82. list in the source header comment and include this doc file. 
  83.  
  84. * This copyrighted code is released for non-commercial use only. *
  85. * It may not be sold or used as part of a commercial package.    *
  86.  
  87.  
  88.   Experiment and enjoy!
  89.  
  90.     Drew Wells [CIS 73767,1244]
  91.     P.O. Box 952
  92.     Los Alamitos, CA
  93.     90720
  94.  
  95.     December 1990 
  96.  
  97.  
  98.  
  99.  
  100.